home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 2 / Gold Medal Software Volume 2 (Gold Medal) (1994).iso / utils / tsx411a.arj / INSTALL.DOC < prev    next >
Text File  |  1993-10-01  |  18KB  |  413 lines
  1.  
  2.  
  3.                               Installing TSX-Lite
  4.  
  5.  
  6.  
  7.       Installation of TSX-Lite is a simple process which  takes  about  10
  8.       minutes.   The  installation process will create the TSX-Lite system
  9.       directory, usually named TSX32SYS,  on  the  destination  disk.   It
  10.       will  extract  the  TSX-Lite  system files from compressed libraries
  11.       and write  them  into  this  directory.   The  TSX  kernel  program,
  12.       TSX32.SYS,  will  be  copied to the root directory of your C: drive.
  13.       When the installation is complete, your current  directory  will  be
  14.       the  TSX-Lite  system  directory  on the destination drive.  The TSX
  15.       installation process does not modify AUTOEXEC.BAT or CONFIG.SYS.
  16.  
  17.       The TSX-Lite  operating  system  coexists  peacefully  on  the  same
  18.       computer  with  DOS.   To  start  TSX-Lite  you first boot DOS, then
  19.       change to the TSX-Lite system directory  (usually  named  \TSX32SYS)
  20.       and issue the RUNTSX command.
  21.  
  22.       See   Section  1.13  on  page  7  for  information  about  obtaining
  23.       technical assistance.
  24.  
  25.  
  26.       1.1 Hardware Requirements
  27.  
  28.       TSX-Lite requires a 386 or 486 based system with at least  4  MB  of
  29.       memory.   VGA  and  MDA  display adapters are supported as well as a
  30.       variety  of  disk  adapters.   Disk  compression  schemes  such   as
  31.       DoubleSpace and Stacker are not supported.
  32.  
  33.  
  34.       1.2 Disk Space Requirements
  35.  
  36.       After  installation,  the  distributed  files in the TSX-Lite system
  37.       directory will occupy approximately 5 Mb.  In addition,  the  kernel
  38.       file,  TSX32.SYS (which is always placed in the root of the C drive)
  39.       will require about 1 Mb.
  40.  
  41.       However, when you  start  TSX,  a  virtual  memory  "page  file"  is
  42.       created  in  the  TSX system directory which, by default, occupies 4
  43.       MB of disk space.  The name of the page  file  is  PAGEFILE.TSX  and
  44.       its  size  is  determined  by  the  TSX  system generation parameter
  45.       PGFILSIZ.  The page file is used to hold the virtual memory  portion
  46.       of  programs  that  are  not  currently present in main memory.  The
  47.       PGFILSIZ parameter is discussed in the TSX-Lite documentation.   The
  48.       total  required  disk space for a running TSX-Lite system is roughly
  49.       10 megabytes.
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                        1
  59.  
  60.       1.3 Installation Modes
  61.  
  62.       TSX-Lite is distributed both on  floppy  disks  and  via  electronic
  63.       distribution.   In either case, you will run an installation program
  64.       which will:
  65.  
  66.         . Create the TSX-Lite directory on your hard disk.
  67.  
  68.         . Decompress the TSX-Lite files into that directory.
  69.  
  70.         . Ask you a series of questions about your system,  and  create  a
  71.           configuration  file  based  on  your  answers  and  what  it can
  72.           automatically detect about your system.
  73.  
  74.  
  75.       1.4 Floppy Disk Installation
  76.  
  77.       If you received TSX-Lite on floppy disks, you  are  ready  to  start
  78.       the  installation.   Simply  insert Disk #1 in drive A or B and type
  79.       the command
  80.  
  81.           x:INSTALL
  82.  
  83.       where x is either A or B depending on which diskette drive  you  are
  84.       using.
  85.  
  86.       Now  proceed  to  Section  1.6  which  describes  the details of the
  87.       installation process.
  88.  
  89.       When the installation is finished, the TSX-Lite documentation  files
  90.       will   be   stored   in   the  TSX32SYS  directory.   To  print  the
  91.       documentation, simply type PRINT *.DOC after booting  TSX-Lite  (the
  92.       TSXLITE.DOC manual is about 175 pages long).
  93.  
  94.  
  95.       1.5 Installation from ZIP Files
  96.  
  97.       If  you  downloaded  TSX-Lite from a bulletin board, you should have
  98.       four files with an extension of .ZIP.  The first file in the  series
  99.       contains  the  TSX-Lite  documentation, and is much smaller than the
  100.       others.   You  may  wish  to  download  this  file  and   read   the
  101.       documentation before downloading and installing TSX-Lite.
  102.  
  103.       You   will   have   to   "unzip"  these  files  before  running  the
  104.       installation program.  To do this, use the PKUNZIP utility  program.
  105.       If  you  do not have a copy of PKUNZIP, you can download it from the
  106.       same bulletin board where you got TSX-Lite.  Note, each of the  four
  107.       .ZIP  files  contains a file named FILE_ID.DIZ.  These files provide
  108.       descriptive information for bulletin boards  but  are  not  used  by
  109.       TSX-Lite.
  110.  
  111.       To  unzip  the files, create a temporary directory on your hard disk
  112.       and "CD" to that directory.   Now,  copy  all  .ZIP  files  to  that
  113.       directory.  Then, type the command
  114.  
  115.  
  116.  
  117.                                        2
  118.  
  119.           PKUNZIP -O *
  120.  
  121.       You  should  now have the following files in the temporary directory
  122.       in addition to the ZIP files:
  123.  
  124.           INSTALL.EXE      ! The installer program
  125.           TSX-32.001       ! TSX-Lite compressed file #1
  126.           TSX-32.002       ! TSX-Lite compressed file #2
  127.           TSX-32.003       ! TSX-Lite compressed file #3
  128.           TSXLITE.DOC      ! The TSX-Lite documentation
  129.           REGISTER.DOC     ! TSX-Lite registration information
  130.           INSTALL.DOC      ! This file
  131.           READ.ME          ! Basic information about TSX-Lite
  132.           FILE_ID.DIZ      ! Information file for BBS sysops
  133.  
  134.       Now, simply type INSTALL to start the  installation  program.   When
  135.       you  have  completed  the installation, copy the documentation files
  136.       to another directory, or print them out with the TSX command
  137.  
  138.           PRINT *.DOC.
  139.  
  140.       You may then erase the files in the temporary directory.
  141.  
  142.  
  143.       1.6 The Installation Program
  144.  
  145.       The Install program will display a  Main  Menu  with  the  following
  146.       options:
  147.  
  148.           Install TSX-Lite
  149.           Copy Individual Files
  150.           Exit
  151.  
  152.       The  first option, Install TSX-Lite, will be highlighted, and is the
  153.       appropriate one for all new  systems  and  system  upgrades.   Press
  154.       Enter to select this option.
  155.  
  156.       If  you  make  an error any time during the installation process and
  157.       wish to exit, simply  press  Ctrl-X.   You  may  then  re-start  the
  158.       installation.
  159.  
  160.       If  this  is a new installation, the installation program will check
  161.       the system for adequate memory and disk space, and  will  check  the
  162.       CONFIG.SYS   file   for   possible  device  driver  conflicts.   The
  163.       following types of drivers many  interfere  with  TSX-Lite  when  it
  164.       begins  running:  Extended  memory  managers  such  as  QEMM.SYS and
  165.       HIMEM.SYS;  disk  caching  programs  such  as   SMARTDRV.SYS;   disk
  166.       compression programs such as DBLDISK.SYS and Stacker.
  167.  
  168.       If  your  system contains multiple hard disks, the program will then
  169.       display a menu of available drives for you to select where you  wish
  170.       to  install  TSX-Lite.   Use  the cursor keys or press the letter of
  171.       the drive you select, then press Enter.  The selected  drive  should
  172.       have  at  least  11  Megabytes  free.  The hard drive choices are as
  173.       follows:
  174.  
  175.  
  176.                                        3
  177.  
  178.         . Standard  AT  -  This  is  the  most  common  catagory  of  disk
  179.           controller,  and includes ISA-bus, EISA-bus, and IDE controllers
  180.           as well as ESDI and MFM/RLL.  If in doubt, select this option.
  181.  
  182.         . Adaptec 1540 SCSI - Includes the 1542 and compatibles,  and  the
  183.           EISA 1742 in standard mode.
  184.  
  185.         . Adaptec  1740  SCSI/Enhanced  mode  - Select when using the 1742
  186.           controller in enhanced mode.
  187.  
  188.         . Western Digital 7000 SCSI - This includes the  FAAST  family  of
  189.           controllers for ISA and EISA machines.
  190.  
  191.         . Unisys/Convergent  SCSI - a proprietary controller found only on
  192.           Unisys machines.
  193.  
  194.         . Standard PS/2 - This is the standard  controller  provided  with
  195.           most IBM PS/2 machines.
  196.  
  197.         . PS/2 SCSI - This is the IBM SCSI controller for the PS/2.
  198.  
  199.       You  will  now  be  asked a series of questions to determine whether
  200.       certain detached jobs should be started at system bootup.  The  jobs
  201.       which  may  be  started  are  the print spooler and the window print
  202.       facility.  Reply "Y" for each job your system will  require.   These
  203.       selections  can  be changed later by using the TSGEN program.  If in
  204.       doubt about an option the safest choice is "Y".
  205.  
  206.       The installation  program  will  now  begin  extracting  files  from
  207.       compressed  libraries  and  copying them to your selected hard disk.
  208.       Please do not interrupt this process until it is finished.
  209.  
  210.       After all files are copied, the installation process will  create  a
  211.       file   named  TSX32.GEN  in  your  TSX-Lite  system  directory  with
  212.       information about your configuration and choice of  options.   Then,
  213.       the  TSGEN  program will run, applying the GEN options to the kernel
  214.       file, C:\TSX32.SYS.  The TSX-Lite manual explains how  you  can  use
  215.       TSGEN to customize and optimize TSX-Lite for your needs.
  216.  
  217.       The  installation  procedure checks for the presence of the COM1 and
  218.       COM2 serial ports and defines them as TSX devices TTB0 and  TTC0  if
  219.       they  are  present.   See the TSXLITE.DOC file for information about
  220.       setting up COM3 and COM4 ports.
  221.  
  222.  
  223.       1.7 Starting TSX-Lite
  224.  
  225.       Since TSX-Lite is an operating system and must have full  access  to
  226.       the  computer  when  it  starts  running,  some  TSR programs or DOS
  227.       device drivers may interfere with it.   In  particular,  you  should
  228.       remove  any  of  the  following  programs  and/or  drivers from your
  229.       CONFIG.SYS  and  AUTOEXEC.BAT  files  and  reboot  before   starting
  230.       TSX-Lite:
  231.  
  232.  
  233.  
  234.  
  235.                                        4
  236.  
  237.         . Memory  managers  such  as QEMM.SYS and HIMEM.SYS.  TSX-Lite has
  238.           its own virtual memory manager built into it.
  239.  
  240.         . Disk compression schemes such as Stacker or DoubleSpace.   Note:
  241.           TSX-Lite  does  NOT  support  disk  compression  and if you have
  242.           compressed  your  disks  you  will  need  to  decompress  before
  243.           starting TSX-Lite.
  244.  
  245.         . Disk caching programs such as SMARTDRV.SYS.
  246.  
  247.       When  the  installation  procedure completes, make sure your current
  248.       directory is the TSX-Lite system directory (normally  TSX32SYS)  and
  249.       type  RUNTSX  to  start  TSX.   A  screen will appear displaying the
  250.       progress of the  bootup  process.   When  system  initialization  is
  251.       finished  (it  takes  15  to  30 seconds), you will see the TSX-Lite
  252.       greeting and a system prompt.   To  return  to  DOS,  type  the  TSX
  253.       "SHUTDOWN" or "BOOT" commands.
  254.  
  255.       If  the  TSX-Lite  start-up  process  fails,  save  a  copy  of your
  256.       CONFIG.SYS and AUTOEXEC.BAT files, create minimal ones  without  any
  257.       TSR's  or  unnecessary device drivers, reboot, and then try to start
  258.       TSX-Lite again.  See Section 1.12 for  solutions  to  some  possible
  259.       problems.
  260.  
  261.  
  262.       1.8 Using TSX-Lite
  263.  
  264.       When  TSX-Lite  starts it prints a welcome message and then displays
  265.       a command prompt.  At this point you may type TSX  commands  or  run
  266.       your  own  application  programs.   You may want to try a few of the
  267.       following commands to get a  feeling  for  the  system:  "TSXSHELL",
  268.       "HELP",   "SYSMON",   "FMAN",   "SHOW  SYSTEM",  "SHOW  USE",  "SHOW
  269.       TERMINALS",  "SHOW  MEMORY",  "SHOW  PAGING",  "SHOW  CACHE",  "SHOW
  270.       FILES", "SHOW FSTATUS", "SHOW ERRORS".
  271.  
  272.  
  273.       1.9 Documentation Files
  274.  
  275.       The  following  documentation files are provided with TSX-Lite.  See
  276.       the  REGISTER.DOC  file  for  information  about  purchasing   other
  277.       manuals.
  278.  
  279.       TSXLITE.DOC  -- Reference manual for TSX-Lite.
  280.       REGISTER.DOC -- Registration information and order form.
  281.       INSTALL.DOC  -- Installation instructions.
  282.       README.DOC   -- Basic introductory information.
  283.       VENDOR.DOC   -- Information for vendors.
  284.  
  285.  
  286.       1.10 System Upgrades
  287.  
  288.       The  installation program will detect if TSX is already installed on
  289.       the target drive.  If so,  you  will  not  be  asked  the  questions
  290.       mentioned  above  and  the  new files will simply be copied over the
  291.       old ones.
  292.  
  293.  
  294.                                        5
  295.  
  296.       Certain files which  are  considered  "user-specific"  will  not  be
  297.       overwritten.   These  include  the  GEN file, startup command files,
  298.       etc.  A list of these files will  appear  on  the  screen  (see  the
  299.       following  section  for  a complete list).  If you wish any of these
  300.       files to be replaced, press Ctrl-X  to  exit,  delete  the  file(s),
  301.       then restart the installation program.
  302.  
  303.  
  304.       1.11 Copy Individual Files Installation Option
  305.  
  306.       Use  this  option  to  copy  one  or  more  selected  files from the
  307.       distribution disks.  Because files are stored  on  the  distribution
  308.       disks  in  compressed  format,  they cannot be copied to your system
  309.       with the COPY command.
  310.  
  311.       When you select this option, you will be prompted for the name of  a
  312.       file  to  copy.  Type the filename and extension only, with no drive
  313.       or directory specification.  Press Enter to continue.  You will  now
  314.       be  prompted for another file to copy.  You may continue to enter as
  315.       many files  as  you  wish  in  this  way.   Wildcard  filenames  are
  316.       acceptable.
  317.  
  318.       Simply  press  Enter  without entering a filename when you are done.
  319.       All files you selected will now be copied to the TSX-Lite  directory
  320.       on  your  system.   If  you asked for the file TSX32.SYS, it will be
  321.       copied to the root directory on drive C:.
  322.  
  323.       Certain  files  are  known  by  the  Installation  program   to   be
  324.       user-modifiable.   The  Installation  program  will  not  copy these
  325.       files to your hard disk if another file with the same  name  already
  326.       exists.   To get a new copy of these files, you must first erase the
  327.       original copy.  The files in this category are as follows:
  328.  
  329.          START.CMD
  330.          LSTARTUP.CMD
  331.          LSHUTDOWN.CMD
  332.          STARTQUE.CMD
  333.          QINIT.CMD
  334.          E32.INI
  335.          KERMIT.INI
  336.          *.KEY
  337.  
  338.  
  339.       1.12 Possible Installation Problems
  340.  
  341.       1.  During the installation process, a message appears of  the  form
  342.           "We  had  a  problem reading a file." This indicates a corrupted
  343.           compressed distribution  library  file.   Please  obtain  a  new
  344.           distribution.
  345.  
  346.       2.  During  the  execution  of  the TSGEN program (immediately after
  347.           the installation program "farewell" screen), an "out of  memory"
  348.           message  appears.   TSGEN  requires  a substantial amount of DOS
  349.           memory.  It cannot use EMS  or  XMS.   Remove  all  drivers  and
  350.  
  351.  
  352.  
  353.                                        6
  354.  
  355.           TSR's  from  your CONFIG.SYS and AUTOEXEC.BAT files, reboot, and
  356.           try again.
  357.  
  358.       3.  The TSX boot process fails with a message  of  the  form  "error
  359.           opening  keyboard  monitor."  This  indicates that TSX is having
  360.           trouble finding its files on  the  hard  disk.   Run  the  TSGEN
  361.           program,  select  "Set  Tuning  Parameters",  then  select  "All
  362.           Parameters".  Press the  letter  "S"  and  scroll  down  to  the
  363.           parameter  SYSDEV,  then  press enter.  This parameter tells TSX
  364.           where its files are stored.
  365.  
  366.           The disk drive is specified as DHxy:  where  'x'  indicates  the
  367.           disk  (a  letter)  and 'y' indicates a partition on that disk (a
  368.           number).  So, for example, the C drive is always DHA0:.   The  D
  369.           drive  may  be  either  DHA1:  if it is the 2nd partition on the
  370.           first disk, or DHB0: if it is the 1st partition  on  the  second
  371.           disk.   Verify  that  the  SYSDEV parameter contains the correct
  372.           disk name.  See the TSX-Lite documentation for more  information
  373.           on running the TSGEN program.
  374.  
  375.       4.  The  boot process fails with a message of the form "Error moving
  376.           data" or "Error allocating memory."  This  usually  indicates  a
  377.           conflict  with  a  DOS  memory  manager  or  device driver.  Try
  378.           removing all such drivers from the CONFIG.SYS  and  AUTOEXEC.BAT
  379.           files  and rebooting the computer.  If the problems persist, try
  380.           running the CMOS setup program for your computer  and  disabling
  381.           all ROM and video shadowing.
  382.  
  383.       5.  The   boot  process  completes  successfully  and  the  greeting
  384.           message appears on the screen, but  the  system  appears  to  be
  385.           "dead."  This  symptom  may  occur  when  TSX  has had a problem
  386.           initializing the keyboard.  Reboot  the  computer  and  run  the
  387.           TSGEN  program.   Select  "Set  Tuning  Parameters", then select
  388.           "Console Keyboard Parameters".  Increase the value of  KBDELAY1,
  389.           KBDELAY2,  KBDELAY3,  and  KBDELAY4  to 30000 (thirty thousand).
  390.           Exit  TSGEN  and  try  running  TSX  again.   See  the  TSX-Lite
  391.           documentation   for   more  information  on  running  the  TSGEN
  392.           program.
  393.  
  394.       6.  The screen goes blank  after  entering  the  RUNTSX  command  to
  395.           start  TSX.   TSX  is  having a problem with your video adapter.
  396.           Try setting the adapter to its most basic mode and  try  booting
  397.           again.
  398.  
  399.  
  400.       1.13 Telephone Support
  401.  
  402.       If  you  need assistance installing TSX-Lite you are welcome to call
  403.       the S&H support team.  The fee for this service is $1.50 per  minute
  404.       which  may  be  charged  to  a Visa, MasterCard, or American Express
  405.       credit card.  There is a $10.00 minimum charge for each  call.   The
  406.       S&H support number is 615-327-3670.
  407.  
  408.  
  409.  
  410.  
  411.  
  412.                                        7
  413.